home *** CD-ROM | disk | FTP | other *** search
/ Mission 3 / Mission 3.zip / Mission 3.iso / vollvers / egonlt98 / manual.txt < prev    next >
Text File  |  1998-05-29  |  20KB  |  406 lines
  1.  
  2.  
  3.          E G O N !    CD-Utilities 3.1.X LIGHT-VERSION
  4.  
  5.          (c) 1998 by M.u.C.S.
  6.  
  7.              M.u.C.S.
  8.              Sacha Roth
  9.              Gustav-Adolf-Straße 11
  10.              D-30167 Hannover
  11.  
  12.              FON :  +49 (0)511 71 00 599
  13.              FAX :  +49 (0)511 71 00 845
  14.  
  15.              http://home.t-online.de/home/MUCS-Hannover
  16.              Email:MUCS-Hannover@t-online.de
  17.  
  18.  
  19.          (p) Peter Hilbring, Dez. 97
  20.  
  21.           *** Diese Anleitung stammt von der großen Version inkl. Zu
  22.               satzprogramme. Für die LIGHT-Version sind nur EGON!-An-
  23.               gaben relevant. Die LIGHT-Version beinhaltet keine Zu-
  24.               satzprogramme oder Tools.
  25.  
  26.  
  27.  
  28.         Was steht in der Anleitung ?
  29.  
  30.           Was ist EGON! ?
  31.           Was kann EGON! ?
  32.           Wie schließe ich ein CD-ROM an meinen ATARI™ an ?
  33.           Welche CD-ROM Laufwerke kann ich benutzen ?
  34.           Wie installiere ich die EGON! CD-Utilities ?
  35.           Was befindet sich auf der Diskette ?
  36.           Aufbau der CONFIG.SYS Datei
  37.           EGON! für den Programmierer
  38.             Aufbau der EGON_INFO-Struktur
  39.             Die Parameterübergabe an die Funktionen
  40.             Welche Funktion ist wozu zu gebrauchen ?
  41.           EGON! und MetaDOS
  42.           Anmerkungen
  43.  
  44.  
  45.         Was ist EGON! ?
  46.  
  47.           EGON! ist ein MetaDOS CD-ROM Treiber der auf allen ST Modellen,
  48.           angefangen beim kleinsten ST, bis hin zum TT oder Falcon030
  49.           funktioniert. (Erste Tests am HADES liefen ebenfalls positiv)
  50.           Damit die Installation von EGON! ebenso einfach wie die
  51.           Installation einer Festplatte funktioniert befindet sich auf der
  52.           ORIGINAL-Diskette ein Installationsprogramm (EGONINST.APP).
  53.  
  54.  
  55.         Was kann EGON! ?
  56.  
  57.           EGON! ermöglicht es Ihnen auf eine CD in einem angeschlossenen
  58.           CD-ROM Laufwerk genauso zuzugreifen wie auf eine Partition einer
  59.           Festplatte oder eine Diskette. Sie können fast alles mit einer
  60.           CD machen was sie auch mit einer "normalen" Festplatte oder
  61.           Diskette machen könnten, ...
  62.           ... nur Schreiben auf eine CD geht leider nicht.
  63.  
  64.  
  65.         Wie schließe ich ein CD-ROM an meinem ATARI™ an ?
  66.  
  67.           Nichts einfacher als das. Ein CD-ROM Laufwerk wird genau wie
  68.           eine Festplatte mit Ihrem ATARI™ Computer verbunden. Bei einem
  69.           externen CD-ROM Laufwerk verbinden Sie den Computer mit einem
  70.           ACSI-Interface oder einem SCSI-Kabel mit der entsprechenden
  71.           Buchse des CD Laufwerks. Nun müssen Sie das CD-ROM nur noch mit
  72.           STROM versorgen und es kann losgehen.
  73.           Bei internen Laufwerken wie sie in Towern zum Einsatz kommen
  74.           verfahren Sie ebenso.
  75.           Genauere Informationen entnehmen Sie dem Handbuch des ATARI™
  76.           Computers oder der Anleitung zu Ihrem ACSI-Interface.
  77.  
  78.  
  79.         Welche CD-ROM Laufwerke kann ich benutzen ?
  80.  
  81.           Im Prinzip funktioniert jedes SCSI-Laufwerk an Ihrem ATARI™.
  82.           Dieses schließt leider die "billig-AT-Bus-Laufwerke" aus, die an
  83.           IBM-kompatiblen PCs benutzt werden können. Einige besonders
  84.           "preiswerte" CD-Laufwerke bereiten teilsweise Probleme z.B.
  85.           bei der AUDIO CD-Funktion. 
  86.  
  87.  
  88.         Wie installiere ich die EGON! CD-Utilities ?
  89.  
  90.           Schließen Sie das CD-ROM Laufwerk, wie oben beschrieben, an
  91.           Ihren Computer an. Nun legen Sie die NICHT schreibgeschützte
  92.           EGON! Installationsdiskette in Laufwerk A und führen mit der
  93.           linken Maustaste einen Doppelklick auf das Symbol für das
  94.           Diskettenlaufwerk A auf dem Desktop aus. In dem sich nun
  95.           "öffnenden Fenster befinden sich mehrere Dateien.
  96.           Suchen Sie nun die Datei EGONINST.APP und starten sie das
  97.           Programm durch einen Doppelklick auf diese Datei.
  98.           Nach wenigen Augenblicken erscheint der erste Benutzerdialog des
  99.           Installationsprogrammes in dem Sie aufgefordert werden ihren
  100.           Namen und ihre Anschrift in die dafür vorgesehenen Felder
  101.           einzutragen. Außerdem sollten Sie noch die Seriennummer, welche
  102.           Sie auf dem Diskettenlabel der ORIGINAL-Diskette finden, in das
  103.           entsprechende Feld eintragen. Bitte gehen Sie bei diesen
  104.           Einträgen sorgfältig vor und tragen Sie keine Phantasienamen
  105.           oder ähnliches ein da Updates nur durchgeführt werden können
  106.           wenn Ihre eingegebenen Daten korrekt sind.
  107.           Sobald alles richtig eingegeben wurde klicken Sie bitte mit der
  108.           LINKEN Maustaste auf den INSTALLIERE... Button.
  109.           Jetzt sehen Sie den zweiten Benutzerdialog des EGON!
  110.           Installationsprogrammes. In diesem Dialog stellen Sie über
  111.           Popupmenues das Laufwerk ein, auf dem die EGON! CD-Utilities
  112.           installiert werden sollen. Hier sollte man das Laufwerk anwählen
  113.           von dem aus auch Ihr ATARI™ Computer gebootet wird. Normalerweise
  114.           ist dies Laufwerk C.
  115.           Als nächstes müssen Sie die Geräteadresse Ihres CD-ROM
  116.           Laufwerkes eintragen. Wie Sie die Geräteadresse Ihres CD-ROM
  117.           Laufwerkes ermitteln können entnehmen Sie der Anleitung des
  118.           Laufwerkes. Wichtig ist, daß das CD-ROM nicht von Ihrem
  119.           Festplattentreiber angesprochen werden darf. Wenn Sie den
  120.           ATARI™-Treiber benutzen lassen Sie eine ID zwischen den
  121.           Festplatten und dem CD-ROM frei. Auf diese Art kann der ATARI™
  122.           Treiber das CD Laufwerk nicht mehr finden und ansprechen. Bei
  123.           anderen Treibern entnehmen Sie bitte dem entsprechendem
  124.           Handbuch wie man bestimmte Geräteadresse ausblendet.
  125.           Nun haben Sie die Qual der Wahl unter welchem Buchstaben das
  126.           CD-ROM Laufwerk verwaltet werden soll. So steht A für das erste
  127.           Diskettenlaufwerk, B für das zweite, C für die erste
  128.           Festplattenpartition und so weiter. Es ist zweckmäßig für das
  129.           CD-ROM einen Buchstaben zwischen D und P zu benutzen da es
  130.           Programme gibt die auf Laufwerke größer P nicht zugreifen können
  131.           (obwohl der EGON!-Treiber Laufwerksbuchstaben bis V verwalten
  132.           kann).
  133.           Als letztes geben Sie bitte den Anschluß an, an dem Sie das
  134.           CD-ROM Laufwerk betreiben möchten. Bei einem ST ist dies der
  135.           ACSI-Port, bei einem Falcon030 der SCSI-Port. Bei einem TT haben
  136.           Sie die freie Auswahl, je nachdem ob Sie das Laufwerk über ein
  137.           ACSI-Interface oder direkt am SCSI-Bus betreiben möchten.
  138.           Bei der Installation wird auf dem Installationslaufwerk nach dem
  139.           AUTO- und nach dem METADOS-Ordner gesucht und eventuell angelegt.
  140.           In den AUTO-Ordner kopiert das EGON! Installationsprogramm die
  141.           Dateien METADOS.PRG und CONFIG.SYS. In den METADOS-Ordner kommen
  142.           die Geräte- und Dateisystemtreiber ISO9660F.DOS und EGON.BOS.
  143.           Das war auch schon alles. Nun können Sie einen Reset
  144.           durchführen und sich an Ihren neuen CD-ROM erfreuen.
  145.  
  146.  
  147.         Was befindet sich auf der Diskette ?
  148.  
  149.           \EGONINST.APP                  Das Installationsprogramm
  150.           \EGONINST.RSC                  Resourcefile
  151.           \MANUAL.TXT                    Dieser Text
  152.           \READ.ME                       Wenn vorhanden, letzte
  153.                                          Ergänzungen zum Handbuch
  154.           \METADOS\METADOS.PRG           ATARI™s Metados Treiber
  155.           \METADOS\CONFIG.SYS            Beispiel CONFIG.SYS Datei
  156.           \METADOS\README.TXT            Readme Text von ATARI™
  157.           \METADOS\ISO9669F.DOS          ISO 9660 Dateisystemtreiber
  158.           \METADOS\HSMAY.DOS             High Sierra Dateisystemtreiber
  159.           \METADOS\CDARGEN.BOS           Treiber für ATARI™ CDAR-504
  160.           \LIB\METADOS.O                 MetaDOS Library für Pure C
  161.           \LIB\METADOS.H                 MetaDOS Headerfile
  162.           \LIB\TEST.C                    Beispielsourcen zu der Library
  163.           \LIB\TEST.TOS                  Beispielprogramm
  164.           \LIB\TEST.PRJ                  Projektdatei für Pure C
  165.           \DEMO\EGONINSD.APP             Demoversion von EGON!
  166.                                          Die Demoversion ist auf eine
  167.                                          Laufzeit von maximal 15 Minuten
  168.                                          beschränkt.
  169.           \DEMO\EGONINST.RSC             Resourcefile
  170.           \DEMO\CD-EXAM.TTP              Low-Level SCSI Tools
  171.           \DEMO\DVS_CONV.APP             DVS nach AVR/AIFF Konverter
  172.           \DEMO\EGON_DVS.APP             DVS-Player für F030
  173.           \CPX\EGONLOCK.CPX              CPX zum Verriegeln des CD-ROMs
  174.           \CPX\EGONLOCK.TXT              Anleitung dazu
  175.           \CPX\EGONPLAY.CPX              CPX zum Spielen von Audio-CDs
  176.           \CPX\EGONPLAY.TXT              Anleitung dazu
  177.  
  178.         Aufbau der CONFIG.SYS Datei
  179.  
  180.           ;
  181.           ; Config.sys  Beschreibung der Systemkonfiguration.
  182.           ;
  183.           ; Physical Basic operating system format
  184.               ;*BOS, [Physical Bos driver][Arguments],
  185.               ;      [Physical id]:[DMA channel], ...
  186.               ; Device #        meaning
  187.           ;     0 - 7           ACSI device 0 - 7
  188.           ;     8 - 15          SCSI device 0 - 7
  189.           ;
  190.           ; Die folgende Zeile meldet EGON.BOS als ACSI-Gerät 4 an
  191.           *BOS, C:\METADOS\EGON.BOS, Y:4
  192.           ;
  193.           ; Logical DOS format. (Dateisystem Treiber)
  194.           ;*DOS  [Logical DOS] [Arguments], [Logical id]:[physical id],...
  195.           ;
  196.           ; Als nächstes wird der EGON_ISO.DOS Treiber auf dem MetaDOS
  197.           ; Gerät Y (welches die ACSI-Adresse 4 verwaltet, s.o.) als
  198.           ; GEMDOS Laufwerk P installiert. Wie schon bei der Installation
  199.           ; Erklärt wurde ist es vorteilhaft ein GEMDOS Laufwerk bis
  200.           ; maximal P zu wählen, da einige Programme auf höhere Laufwerke
  201.           ; nicht zugreifen können.
  202.           *DOS, C:\METADOS\EGON_ISO.DOS, O:Y
  203.           ;
  204.           ; MetaDOS kann auch Programme automatisch starten.
  205.           ;
  206.           c:\auto\boot\ram512.prg       ; Load in 512 byte ramdisk.
  207.           c:\auto\boot\gdos.prg         ; Load in gdos.
  208.           c:\auto\boot\diab630.prg      ; Load in diablo 630 emulator.
  209.               c:\auto\boot\sdump.prg    ; Load in Screen dump to laser.
  210.  
  211.  
  212.         EGON! für den Programmierer
  213.  
  214.           EGON! legt bei erfolgreicher Installation einen Cookie an.
  215.           Die Bezeichnung des Cookies ist EGON. Der Cookie zeigt auf eine
  216.           Struktur die Einsprungadressen für grundlegende Lese- und
  217.           Schreibroutinen enthält. Über diese Routinen kann man auf
  218.           einfache Art und Weise Daten über den ACSI- bzw. SCSI-Bus
  219.           übertragen.
  220.  
  221.           Aufbau der EGON_INFO-Struktur:
  222.  
  223.              typedef struct
  224.              {
  225.                 void *smplscsi;  /* Zeiger auf smplscsi                     */
  226.                 void *rcvscsi;   /* Zeiger auf rcvscsi                      */
  227.                 void *wrtscsi;   /* Zeiger auf wrtscsi                      */
  228.                 void *clrcmdblk; /* Zeiger auf clrcmdblk                    */
  229.                 void *cmdblk;    /* Zeiger auf cmdblk                       */
  230.                 UBYTE *info;     /* Zeiger auf Versionsstring               */
  231.                 int  id;         /* Adresse des CD-ROM Laufwerks            */
  232.                 int  log_drv;    /* Logische Metados Laufwerks ID           */
  233.                 int  cd_typ;     /* Hersteller des CD-ROMs                  */
  234.                                  /* -1 = Standard CD-ROM                    */
  235.                                  /*  0 = ATARI™ CDAR 502/504                 */
  236.                                  /*  1 = Toshiba CD-ROM                     */
  237.                                  /*  2 = Apple CD150 / Sony 8002 / Pioneer  */
  238.                                  /*  3 = Apple CD300 / Sony 8003 / Sony 561 */
  239.                 int  dma_typ;    /*  0 = Normaler Adapter                   */
  240.                                  /*  1 = ICD Adapter                        */
  241.                                  /*  2 = c't Alia Adapter                   */
  242.                 int  port;       /*  0 = CD-ROM am DMA Port                 */
  243.                                  /*  1 = CD-ROM am SCSI Port                */
  244.              } EGON_INFO;
  245.  
  246.           Zusätzlich gibt es zwei weitere Struktur-Einträge, die allerdings
  247.           einen negativen Offset haben.
  248.  
  249.              Offset  -4:  4 Byte Magic-Word 0x45474f4e
  250.              Offset -24: 20 Byte Zeichenkette "EGON! CD-Utilities",0,0
  251.  
  252.           Die Parameterübergabe an die Funktionen
  253.  
  254.              * smplscsi
  255.                   D0.W : SCSI Unit Nummer (0-15)
  256.                   D1.L : Größe des Übertragungsbuffers in Bytes
  257.                   D2.W : SCSI Befehlslänge (cmdblk) in Bytes
  258.                   A0.L : Adresse des Übertragungsbuffers
  259.  
  260.                   Nach Beendigung der Funktion steht in D0.W ein
  261.                   Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI
  262.                   Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher
  263.                   untersucht werden kann. Bei einem Wert von 0 ist die
  264.                   Funktion ohne Fehler beendet worden.
  265.  
  266.              * rcvscsi
  267.                   D0.W : SCSI Unit Nummer (0-15)
  268.                   D1.L : Größe des Übertragungsbuffers in Bytes
  269.                   D2.W : SCSI Befehlslänge (cmdblk) in Bytes
  270.                   A0.L : Adresse des Übertragungsbuffers
  271.  
  272.                   Nach Beendigung der Funktion steht in D0.W ein
  273.                   Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI
  274.                   Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher
  275.                   untersucht werden kann. Bei einem Wert von 0 ist die
  276.                   Funktion ohne Fehler beendet worden.
  277.  
  278.              * wrtscsi
  279.                   D0.W : SCSI Unit Nummer (0-7)
  280.                   D1.L : Größe des Übertragungsbuffers in Bytes
  281.                   D2.W : SCSI Befehlslänge (cmdblk) in Bytes
  282.                   A0.L : Adresse des Übertragungsbuffers
  283.  
  284.                   Nach Beendigung der Funktion steht in D0.W ein
  285.                   Rückgabewert. Ein Wert ungleich 0 deutet auf einen SCSI
  286.                   Fehler hin, der mit dem SCSI Befehl REQUEST SENSE näher
  287.                   untersucht werden kann. Bei einem Wert von 0 ist die
  288.                   Funktion ohne Fehler beendet worden.
  289.  
  290.              * clrcmdblk
  291.                   A0.L : Zeiger auf eigenen cmdblk.
  292.  
  293.                   Es gibt keinen Rückgabewert.
  294.  
  295.  
  296.           Welche Funktion ist wozu zu gebrauchen
  297.  
  298.              * smplscsi
  299.                   Diese Funktion dient zum Verschicken von einfachen SCSI
  300.                   Befehlen (ohne zusätzliche Daten) wie TEST UNIT READ
  301.                   oder START UNIT.
  302.  
  303.              * rcvscsi
  304.                   Diese Funktion dient zur Datenübertragung vom CD-ROM zum
  305.                   Rechner. Die Daten werden in einem Übertragungsbuffer
  306.                   zurückgeliefert. Ein typischer SCSI Befehl für die
  307.                   Funktion ist READ.
  308.  
  309.              * wrtscsi
  310.                   Diese Funktion dient zur Datenübertragung zwischen
  311.                   Rechner und CD-ROM. Da man aber auf ein CD-ROM nicht
  312.                   schreiben kann ist eine sinnvolle Verwendung für diese
  313.                   Funktion nur in der Konfiguration von CD-ROMs mittels
  314.                   des SCSI Befehle MODE SELECT zu sehen.
  315.  
  316.              * clrcmdblk
  317.                   Diese Funktion löscht den treiberinternen cmdblk. Ein
  318.                   lokaler Kommandobuffer wird von dieser Funktion nicht
  319.                   verändert. Es ist allerdings wichtig daß man nach jedem
  320.                   Löschen des lokalen Kommandobuffers die Funktion
  321.                   clrcmdblk aufruft um so "rätselhafte Phänomene" beim
  322.                   Betrieb des Treibers zu vermeiden.
  323.  
  324.  
  325.         EGON! und MetaDOS
  326.  
  327.           EGON! installiert sich mit Hilfe das ATARI™
  328.           MetaDOS-Treiberpaketes. Auf diese Art stehen dem Programmierer
  329.           somit auch die MetaDOS-XBIOS-Funktionen 48 bis 63 zur Verfügung.
  330.           Für diesen Zweck befindet sich auf der Diskette eine
  331.           MetaDOS-Library. Diese Library erfüllt die Pure-C
  332.           Aufrufkonventionen und befindet sich im LIB-Ordner der
  333.           ORIGINALDISKETTE.
  334.  
  335.              Welche Funktionen gibt es in der Library und dem zugehörigem
  336.              Headerfile METADOS.H ?
  337.  
  338.                 typedef struct
  339.                 {
  340.                    ULONG drivemap; /* Tabelle mit Bits für die MetaDOS
  341.                                           Gerätetreiber "A.."Z" (Bit 0: "A") */
  342.                    char *version;       /* Zeichenkette mit Namen und
  343.                                        Versionsnummer von Meta-DOS */
  344.                    LONG  reserved[2];
  345.                 } METAINFO;
  346.  
  347.              int Metainit (METAINFO *buffer);
  348.              int Metaopen (int drive, char *buffer);
  349.              int Metaclose (int drive);
  350.              int Metaread (int drive, char *buffer, long block,
  351.                            int count);
  352.              int Metawrite (int drive, char *buffer,
  353.                             long block, int count);
  354.              int Metaseek (int drive, long block);
  355.              int Metastatus (int drive);
  356.              int Metaioctl (int drive, long magic,
  357.                             int opcode, char *buffer);
  358.              int Metastartaudio (int drive, int flag, char *buffer);
  359.              int Metastopaudio (int drive);
  360.              int Metasetsongtime (int drive, int repeat,
  361.                                   long start, long end);
  362.              int Metagettoc (int drive, int flag, char *buffer);
  363.              int Metadiscinfo (int drive, char *buffer);
  364.              int Metagetdriveno (long drivemap);
  365.  
  366.              Aufruf- und Übergabeparameter:
  367.  
  368.                 Metasetsongtime erwartet START und END im Format welches
  369.                                 von Metagettoc zurückgeliefert wird. REPEAT
  370.                                 wird nicht benutzt.
  371.                 Metaopen        In BUFFER sind ein Zeiger auf den
  372.                                 Versionsstring des BOS Treibers und 3
  373.                                 Null-Zeiger enthalten.
  374.                 Metastartaudio  BUFFER[0].B = Anzahl zu spielender
  375.                                                   Tracks (normalerweise 1)
  376.                                     BUFFER[1].B = Track
  377.                                     FLAG muß 0 sein.
  378.                     Metagettoc      BUFFER[0].B = Track Nr.
  379.                                     BUFFER[1].B bis BUFFER[3].B = Spielzeit
  380.                                     im BCD-Format. Beispiel: $26 $19 $60 heißt
  381.                                 26min 19sec 60/75tel Sekunden.
  382.                                 Dieses Format wird von Metasetsongtime
  383.                                     als Eingabe akzeptiert.
  384.                                     FLAG muß 0 sein.
  385.                     Metadiskinfo    BUFFER[0].B = 0
  386.                                     BUFFER[1].B  = First Track No.
  387.                                     BUFFER[2].B  = Last Track No.
  388.                                     BUFFER[3].B = Track No.
  389.                                     BUFFER[4].L  = Track relativ CD-ROM
  390.                                                    Address
  391.                                     BUFFER[8].L  = Absolute CD-ROM
  392.                                                Address
  393.                                 BUFFER[12].L = End of CD absolute CD-ROM
  394.                                                    Address
  395.                                     BUFFER[16].B = Index No.
  396.                                     Alle Daten liegen im BCD-Code vor.
  397.  
  398.  
  399.             Anmerkungen
  400.  
  401.               ATARI™, MetaDOS, GEMDOS, XBIOS ST, TT und Falcon030 sind
  402.               Warenzeichen der Firma ATARI™ Computer.
  403.  
  404.               Das Installationsprogramm entstand unter Zuhilfenahme der
  405.               EnhancedGEM-LIBRARY von Christian Grunenberg.
  406.